<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>Demo document</title>
<link rel="stylesheet" type="text/css" href="style.css" />
<meta name="description" content="A demo Gregwar/RST document" />
</head>
<body>

<a id="title.1"></a><h1>Gregwar/RST Sandbox</h1>
<p>Reference to <a href="#">HoHo</a></p>
<div class="note"><p><strong>Note</strong>:<br />This is a testing sandbox, if you want to understand how it works, have a
look to the rst original file</p>
</div>
<a id="title.1.1"></a><h2>1) Titles</h2>
<a id="title.1.1.1"></a><h3>1) Using titles</h3>
<p>Titles can be wrote using the underlining, the default order is:</p>
<ol><li><code>=======</code></li>
<li><code>-------</code></li>
<li><code>~~~~~~~</code></li>
<li><code>*******</code></li>
</ol>

<a id="title.1.1.2"></a><h3>2) Using auto-numbering</h3>
<p>This is not a standard of RST but is really useful, you can use the special syntax
<code>#</code> followed by the letter of the title you are in (it resets the counter when used).</p>
<p>You can for instance use <code>Question #*</code> if you are under an <code>*******</code>, the number
displayed will be auto-incremented:</p>
<p><strong> Question #* </strong></p>
<p>The first question</p>
<p><strong> Question #* </strong></p>
<p>The second question</p>
<p>This can of course also be used to number parts, chapter etc.</p>
<a id="title.1.1.3"></a><h3>3) Separator</h3>
<p>A separator is like a title underline but without any text above:</p>
<pre><code class="">-----
</code></pre>
<p>This will result in a text separation:</p>
<hr />
<a id="title.1.2"></a><h2>2) Inline style</h2>
<ul><li><code>*italic*</code> renders as <em>italic</em></li>
<li><code>**strong**</code> renders as <strong>strong</strong></li>
</ul>

<p>You can force a line break by adding an extra space at the end of a line</p>
<a id="title.1.3"></a><h2>3) Tables</h2>
<p>Tables can be created using the line separator <code>====</code>:</p>
<pre><code class="">================     ================
**First column**     **Other column**
================     ================
Second row with      Second row, of the
some contents text   other column
============         ================
</code></pre>
<p>Will result in:</p>
<table><tr><td><strong>First column</strong></td><td><strong>Other column</strong></td></tr><tr><td>Second row with some contents text</td><td>Second row, of the other column</td></tr></table>
<p>Another example:</p>
<table><tr><td>Col A</td><td>Col B</td><td>Col C</td></tr><tr><td>Col X</td><td>Col Y</td><td>Col Z</td></tr><tr><td>Col U</td><td>Col J</td><td>Col K</td></tr></table>
<a id="title.1.4"></a><h2>4) Lists</h2>
<p>Lists can be ordered or unordered, and nested, for instance this:</p>
<pre><code class="">* Element A
    * Sub A, this a
      multiline sentence in the source
        1. Sub ordered as &quot;1&quot;
        2. Sub ordered as &quot;2&quot;
    * Sub hello two
* Element B
</code></pre>
<p>While result in:</p>
<ul><li>Element A</li>
<ul><li>Sub A, this a
      multiline sentence in the source</li>
<ol><li>Sub ordered as &quot;1&quot;</li>
<li>Sub ordered as &quot;2&quot;</li>
</ol>
<li>Sub hello two</li>
</ul>
<li>Element B</li>
</ul>

<a id="title.1.5"></a><h2>5) Blocks</h2>
<a id="title.1.5.1"></a><h3>1) Quoting</h3>
<p>You can quote a block by indenting it:</p>
<pre><code class="">This is a normal pagagraph

    This is a quote
</code></pre>
<p>Will result in:</p>
<p>This is a normal paragraph</p>
<blockquote><p>This is a quote</p>
</blockquote>
<a id="title.1.5.2"></a><h3>2) Code</h3>
<p>You can quote code the same way as quote, but using the <code>::</code> at the end
of the previous paragraph:</p>
<pre><code class="">Here is a piece of code:

.. code-block:: php

    &lt;?php

    echo &quot;I love RST&quot;;
</code></pre>
<p>Will result in:</p>
<p>Here is a piece of code:</p>
<pre><code class="php">&lt;?php

echo &quot;I love RST&quot;;
</code></pre>
<a id="title.1.6"></a><h2>6) Links</h2>
<a id="title.1.6.1"></a><h3>1) Standard links</h3>
<p>Links can be defined once for all using the trailing <code>_</code>, like this:</p>
<pre><code class="">PHP_ is a great language

.. _PHP: http://php.net/
</code></pre>
<p>Will result in:</p>
<p><a href="http://php.net/">PHP</a> is a great language</p>
<a id="title.1.6.2"></a><h3>2) Anonymous links</h3>
<p>Anonymous links can also be used to avoid copying the name just after the
block that uses it, for instance:</p>
<pre><code class="">I love GitHub__

.. __: http://www.github.com/
</code></pre>
<p>Will result in:</p>
<p>I love <a href="http://www.github.com/">GitHub</a></p>
<p>You can use the following shortcut:</p>
<pre><code class="">I love GitHub__

__ http://www.github.com/
</code></pre>
<a id="title.1.6.3"></a><h3>3) Inline links</h3>
<p>You can also define the link target inside the link:</p>
<pre><code class="">Do you know `Google &lt;http://www.google.com&gt;`_ ?
</code></pre>
<p>Will result in:</p>
<p>Do you know <a href="http://www.google.com">Google</a> ?</p>
<a id="title.1.6.4"></a><h3>4) Anchor links</h3>
<p>An anchor can be used like this:</p>
<pre><code class="">.. _anchor:

Some anchor section, you can link to it like `this &lt;#anchor&gt;`_
</code></pre>
<p>Will result in:</p>
<a id="anchor"></a>
<p>Some anchor section, you can link to it like <a href="#anchor">this</a></p>
<a id="title.1.7"></a><h2>7) Directives</h2>
<a id="title.1.7.1"></a><h3>1) Include</h3>
<p>You can include a file with the include pseudo-directive:</p>
<pre><code class="">.. include:: file.rst
</code></pre>
<a id="title.1.7.2"></a><h3>2) Replace</h3>
<p>You can use the replace directive like this:</p>
<pre><code class="">.. |name| replace:: bob

Hello |name| !
</code></pre>
<p>Will result in:</p>
<p>Hello bob !</p>
<a id="title.1.7.3"></a><h3>3) Image</h3>
<p>The <code>image</code> directive can be used to display images, this way:</p>
<pre><code class="">.. image:: rst.png
    :width: 250px
    :title: RST logo
</code></pre>
<p>Will result in:</p>
<img src="rst.png"  width="250px" title="RST logo" />
</body>
</html>
